chhost

Use o comando chhost para alterar o nome ou tipo de um objeto do host. Esse comando não afeta nenhum mapeamento de host existente.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe chhost -typehpuxtpgsgenericopenvmsadminlunhide_secondary -mask port_login_mask-namenew_name_arg-protocolscsinvme-iscsiusernameusername_for_authentication-chapsecretchap_secret-nochapsecret-sitesite_namesite_id-nositenome_do_hosthost_id

Paramêtros

-type hpux | tpgs | generic | openvms | adminlun | hide_secondary
(Opcional) Especifica o tipo do host. Os valores a seguir são os tipos de hosts disponíveis:
  • generic indica o padrão.
  • tpgs indica quando as informações da porta de destino mudam (são dadas atenções extras da unidade ao host).
  • openvms indica OpenVMS.
  • adminlun indica volumes virtuais, que são ativados no host.
  • hpux indica o firmware HP-UX.
  • hide_secondary indica que todos os volumes secundários de relacionamento de cópia remota estão indisponíveis para o host.

O tipo de host para hosts NVMe não pode ser mudado. Para obter informações adicionais sobre hosts que requerem o parâmetro type, consulte a documentação de conexão de host do IBM Spectrum Virtualize for Public Cloud .

-name new_name_arg
(Opcional) Especifica o novo nome que você deseja designar para o objeto do host.
-protocol scsi | nvme
(Opcional) Especifica o protocolo que é usado pelo host para se comunicar com o sistema de armazenamento. O padrão é scsi. O host -protocol não pode ser mudado ao mesmo tempo que o host -type. O protocol de um host pode ser mudado apenas se os seguintes itens forem verdadeiros:
  • Nenhum volume é mapeado para o host.
  • Nenhuma porta está definida no host.
  • O tipo de host é compatível com o novo protocolo. Um host que usa o protocolo NVMe deve ser do tipo generic.
-mask port_login_mask
(Opcional) Especifica quais portas de destino do nó um host pode acessar e a máscara de porta do Fibre Channel (FC) para o host. Os nomes da porta universal (WWPNs) no objeto do host devem acessar volumes a partir das portas de nó que são incluídas na máscara e que estão no grupo de E/S do objeto do host. A máscara de porta é um binário de 64 bits e é composta de uma combinação de números 0 e 1, em que 0 indica que a porta de E/S do FC correspondente não poderá ser usada e 1 indica que poderá. O bit mais à direita na máscara corresponde à porta de E/S FC 1. Os valores de máscara válidos vão de 0000 (nenhuma porta ativada) a 1111111111111111111111111111111111111111111111111111111111111111 (todas as portas ativadas). Por exemplo, uma máscara 111111101101 ativa as portas 1, 3, 4, 6, 7, 8, 9, 10, 11 e 12.
Atenção: Mudar a máscara da porta do host pode resultar em uma perda de acesso. Antes de desativar portas, verifique se o host tem acesso a outras portas.
-iscsiusername username_for_authentication
(Opcional) Especifica o nome do usuário para um objeto host para autenticação unilateral para login de conexão de host do Small Computer System Interface (iSCSI). Se esse parâmetro for especificado, o valor será obtido como o "username" para autenticação unilateral para efetuar login na conexão de host do iSCSI. Se você não especificar o parâmetro iscsiusername, o IQN do objeto do host será usado como o nome do usuário por padrão. Se nenhum parâmetro iscsiusername for fornecido e existirem vários IQNs no mesmo objeto do host, o nome de usuário de cada IQN será o próprio IQN. Se o parâmetro iscsiusername for fornecido para um host de IQNs múltiplos, efetue login em todos os hosts usando o IQN fornecido. Se você usar o parâmetro iscsiusername, deve-se também especificar o parâmetro chapsecret.
-chapsecret chap_secret
(Opcional) Configura o segredo do Challenge Handshake Authentication Protocol (CHAP) que é usado para autenticar o host para a E/S do iSCSI. Esse segredo é compartilhado entre o host e o cluster. O segredo do CHAP para cada host pode ser listado usando o comando lsiscsiauth.
-nochapsecret
(Opcional) Limpa qualquer segredo do CHAP configurado anteriormente para este host. O parâmetro nochapsecret não poderá ser especificado se chapsecret estiver especificado.
-site site_name | site_id
(Opcional) Especifica o valor do site numérico ou o nome do site do host. O nome do site deve ser um valor alfanumérico. O ID do site deve ser 1 ou 2. O site designado a um host pode ser mudado com qualquer topologia: (hyperswap, stretched ou standard).
Nota: Se o host for mapeado para um volume que esteja em um relacionamento ativo/ativo (HyperSwap), não será possível especificar -nosite.
-nosite
(Opcional) Reconfigura o valor do site.
host_name | host_id
(Obrigatório) Especifica, por ID ou pelo nome atual, o objeto de host a ser modificado.

Description

Esse comando pode alterar o nome do host especificado para um novo nome ou pode alterar o tipo de host. Esse comando não afeta nenhum dos mapeamentos de host atual.

A máscara da porta aplica-se a logins da porta do inicializador do host associados ao objeto de host. Para cada login entre uma porta do adaptador de barramento de host (HBA) e uma porta de nó, o nó examina a máscara da porta que está associada ao objeto do host para o qual o HBA de host é um membro e determina se o acesso é permitido ou negado. Se o acesso for negado, o nó responderá aos comandos SCSI como se a porta fosse desconhecida.

Nota: Quando todos os grupos de E/S são removidos de um host iSCSI, o comando lsiscsiauth não exibe a entrada de autenticação desse host. Use o comando addhostiogrp para mapear o host iSCSI para pelo menos um grupo de E/S e, em seguida, use o comando addhostport para incluir a porta iSCSI nele. Você também deve incluir autenticação para esse host usando o comando chhost com o parâmetro chapsecret ou nochapsecret.

Um exemplo de chamada

chhost -name testhostlode -mask 111111101101 hostone

A seguinte saída é exibida:

Sem feedback

Um exemplo de chamada

chhost -type openvms 0

A saída a seguir é exibida:

Sem feedback

Um Exemplo de Chamada

chhost -site site1 host3

A seguinte saída é exibida:

Sem feedback